The Project file

Introduction

Optionally, hsc can maintain a project-file, where it stores some information about the document it currently processes. This includes

name of the html-object created
name of the main hsc-source used
names of all files include (both via user arguments or <$include>)
local IDs defined in this document (using <A NAME="id">)

This enables hsc to check references to local IDs in other documents of your project. Additionally, you can now use hscdepp to maintain the dependencies between hsc-source and html-object and update your Makefile.

How to get started with it

To make hsc keep the project-file up-to-date, you have to use the CLI-option PRJFILE=projec_file. It doesn't matter how you name your project-file, however I suggest to call it hsc.project; this is the default-name hscdepp asumes.

But it's very important to use the same name for the project-file every time you invoke hsc. Otherwise, hsc and hscdepp won't be able to find all required information and will launch warnings or create incomplete dependencies.

For example,you can invoke hsc using

   hsc FROM=hugo.hsc TO=html: PRJFILE=hsc.project

If the project-file does not yet exist, hsc displays a warning. You can ignore this, and the project-file will be created after the (successful) creation of the html-object. The next time you start hsc passing the same project-file, no warning will appear.

Until all documents have been processed (and added therefor been added to the project-file) by hsc at least once, there will also be some occurrences of message #51 you can ignore, too.